home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dskut / sho24.zip / SHO.DOC < prev    next >
Text File  |  1990-04-10  |  6KB  |  112 lines
  1.        Documentation for SHOWDISK by Dwayne Melancon, 76417,600 (CIS).
  2.        
  3. What does it do?
  4. ================
  5. This program provides a quick, easy way to check the space usage for a hard
  6. or floppy disk drive.  It provides a "gas gauge" style usage graph (character
  7. based) that you can read at a glance.  It also provides byte figures (in
  8. kilobytes or Megabytes, whichever is appropriate) on the space allocated and
  9. the space available.
  10.  
  11.  
  12. SYNTAX:   SHO [drive letter] [/M]
  13.  
  14.           If no drive letter is specified, the current drive will be used.
  15.           A colon is not necessary but it won't hurt anything, either.
  16.           Name the program anything you like - I call it SD.COM on my system
  17.           (it's called SHO.COM here because a lot of people have the Norton
  18.           Utilities, in which the command "SD" calls Speed Disk).
  19.  
  20.           /M forces monochrome "colors" for better visibility on composite
  21.              monitors and laptops.  Monochrome monitors are automatically
  22.              detected.
  23.  
  24. Why use it?
  25. ===========
  26. I wrote this program because I was tired of waiting for CHKDSK to run when
  27. all I wanted to do was get a quick check on how much of my disk was in use.
  28.  
  29. This utility will not give exactly the same readings as CHKDSK; the DOS
  30. CHKDSK utility deals in exact bytes, while SHOWDSK deals in allocated
  31. clusters.  What's the difference?  The bytes in CHKDSK indicate the number
  32. bytes you would get if you added up the exact file sizes of all of the
  33. files on your disk.  My utility tells you how many bytes have been ALLOCATED
  34. to those files.  In other words, if you had a standard 30 Mb hard disk
  35. using DOS 3.3 (512 bytes per sector, 4 sectors per cluster), CHKDSK would
  36. tell you that you had 1 byte in 1 user file.  While this is true, CHKDSK
  37. DOESN'T tell you that DOS can only allocate space on this disk in blocks of
  38. 2048 bytes -- it makes you think you have 2047 more usable bytes than you
  39. actually have.  My utility would tell you that you had 2048 bytes allocated
  40. on your disk -- more accurate, eh?
  41.  
  42. Using allocated clusters rather than actual file sizes not only gives a more
  43. accurate indication of the space used on your drive, it makes the program
  44. faster.
  45.  
  46. Upgrading from earlier versions:
  47. ================================
  48. The latest version of SHO is an EXE file.  If you have a previous
  49. version that was "SHO.COM", you must delete it for this one to run since
  50. DOS will execute a COM file before an EXE if both exist in the same
  51. directory.
  52.  
  53.  
  54. DISCLAIMER!!!
  55. =============
  56. SHOWDISK has run successfully on everything I have tried it on.  It does
  57. not write to any disks.  It reads things.  HOWEVER, I have written this
  58. program for the sake of convenience only and will not take responsibility for
  59. any incompatibilities, damage, loss of data or hair, or any damages,
  60. consequential or otherwise resulting from the use of this program.  When you
  61. use this program, you agree not to get mad at me, say mean things about me,
  62. sue me or any other negative things, as I am offering this program as a
  63. utility that has been useful to me that I feel others may like as well.
  64.  
  65. Scary?  Hey, this is a litigious society and I want to make it quite clear
  66. that when you use this program, you do so at your own risk.  Please keep in
  67. mind, however, that the functions performed by this program are quite tame and
  68. benign and that it has never been responsible for any data loss that I know of.
  69. I use it daily, as do many of my friends/testers.
  70.  
  71.                            ***************************
  72.  
  73. Comments on the program are welcome.  Updates are possible, but no promises
  74. can be made -- I do this stuff in my spare time, which has a tendency to be
  75. allocated FOR me, rather than BY me.
  76.  
  77. This program is free.  Distribute it as you wish.  I only ask that you keep
  78. this file (SHO.DOC) with the program when you give it away, and that you
  79. send me a postcard from your city (with your city's name on it).  If you
  80. don't have one, go to your local Holiday Inn and acquire one.  Please include
  81. any comments you have about the program.
  82.         Dwayne A. Melancon
  83.         10049 N. Reiger Road
  84.         Baton Rouge, LA  70809
  85.  
  86.  
  87. Revision history:
  88. =================
  89. Version 1.1  - Added video mode detection functions to make display more
  90.                readable on monochrome monitors.
  91. Version 1.2  - Changed from EXE to COM file.
  92. Version 1.3  - Only used by me and one test site.
  93. Version 1.4  - Provisions made for very large hard drives and network drives
  94.                (special thanks to Randol Tigrett at PC Magazine's LAN Labs for
  95.                his help), and some diagnostic routines were added.
  96.  
  97. Version 2.0  - Switched windowing methods to make things a bit more efficient
  98.                space- and memory-wise.
  99. Version 2.1  - Played around with "exploding" windows.  This version was only
  100.                used by a few people to get a "user response".  We judged it to
  101.                be "neat", but it makes the program seem slower and makes it a
  102.                little bit larger.  Could easily be added as a command line
  103.                option if I get enough requests for it.
  104. Version 2.3  - Back to an EXE, folks.  I found a way to make it smaller and a
  105.                bit faster.  The technique requires that the file be an EXE
  106.                because it doesn't work in Turbo C's Tiny memory model.
  107. Version 2.3d+- The "plus" is for a shadow I added behind the bar to make the
  108.                readout look kind of "3-D" (hence the "3d").
  109. Version 2.4  - Added /M (force monochrome) option.
  110.  
  111. --- EOF ---
  112.